home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / macfile2.zip / MACFILE.DOC < prev    next >
Text File  |  1993-01-24  |  23KB  |  513 lines
  1.  
  2.  
  3.                       ╔═══════════════════════════╗
  4.                       ║ A MÄC's Place BBS Release ║
  5.                       ╚═══════════════════════════╝
  6.  
  7.  
  8.  
  9.                   MACFILE: Roll Your Own File Listing Door
  10.                   ~~~~~~~  ~~~~ ~~~~ ~~~ ~~~~ ~~~~~~~ ~~~~
  11.  
  12.                                Version  2.0
  13.  
  14.  
  15.                     Copyright (c) 1993 John W. McNamara
  16.                              All rights Reserved
  17.     
  18.  
  19.                          Written By: John McNamara      
  20.                         
  21.                               MÄC's Place BBS    
  22.                                   Dunn, NC           
  23.  
  24.                           (919) 891-1111 [16.8 DS] 
  25.                           Release Date: 22 Jan 1993
  26.  
  27. Files Listing................................................    Page 1
  28. Introduction.................................................    Page 2
  29. Operation....................................................    Page 3
  30. Installation.................................................    Page 4
  31. History/Whats New/Future plans...............................    Page 6
  32. Disclaimer...................................................    Page 7
  33. License (What is freeware)...................................    Page 8
  34. Other Products by MÄC's This year............................    Page 9
  35.                                                                        
  36.  
  37. MACFILES - Version 2.0                                           Page - 1
  38.  
  39. ┌────────────────────────────────┐
  40. │ Files included in this Zip:    │
  41. └────────────────────────────────┘
  42.  
  43.     MACFILE.EXE       - Main File MACFILE Executable File, Version 2.0
  44.     MACFILE.CNF       - MACFILE Sample Configuration File
  45.     MACFILE           - MACFILE Sample PCBoard Door File
  46.     MACFILE.DOC       - Information on File MACFILEs Door
  47.     MACFILE.TXT       - MACFILE sample description file
  48.  
  49. MACFILE - Version 2.0                                           Page - 2
  50. ╔══════════════╗
  51. ║ Introduction ║
  52. ╚══════════════╝
  53.  
  54.   Welcome to File  MACFILE, Version 2.0 "Roll Your Own File Listings DOOR".
  55.   Basically there was a need (as explained to me by my users) to have a
  56.   "simple" door in which a user could go into and select file listings
  57.   that interested them for later download.  I know there are other door
  58.   programs that do this and even more extensively than MACFILE however
  59.   spending all your time in a door going through menus and having to
  60.   remember what dir is what takes time, and time is what this DOOR was
  61.   designed to save.  If you wanted to spend alot of time in a door
  62.   selecting directory listings then you might as well grab the ALLFILES
  63.   list that most BBS's provide.  Anyway, I hope you enjoy the MACFILE
  64.   door as much as my users have.  It quickly became the 2nd most used
  65.   door on my bulletin board next to MACSEC (MAC's on-line security update
  66.   door allowing users to upgrade themselves based on sysop parameters).
  67.  
  68.  
  69.  
  70. MACFILE - Version 2.0                                           Page - 3
  71. ╔═══════════════════════════════╗
  72. ║ File MACFILE Door Operation:  ║
  73. ╚═══════════════════════════════╝
  74.  
  75.   The operation of the File MACFILE Door is straight forward. The programme  
  76.   presents the welcome screen and then displays the main menu. 
  77.  
  78.                        File MACFILE/DESTINATION Door
  79. For a 2 file system:
  80.  
  81. [S] Select / Deselect file listings
  82. [H] Help
  83. [A] Select All File Listings
  84. [D] DeSelect All File Listings
  85. [C] Create Download File listing and quit to BBS
  86. [Q] Quit to BBS
  87. [G] Log off BBS
  88. ┌────────┐
  89. │ Select │
  90. └────────┘
  91. By choosing this option, you will be presented with a full file
  92. listing of the BBS.  Simply choose the number of the directories you
  93. want and the "-" will be replaced with an "+"  All files marked with
  94. a "+" will be added to the .ZIP file created by the BBS.  By choosing
  95. a "0" (zero) if there are more than 60 listings it will display the
  96. next screen of directories.  After the second screen and after the
  97. first screen the "0" will take you back to the main menu.  
  98. ┌──────┐
  99. │ Help │
  100. └──────┘
  101. Brings up a full screen help.  The help is slightly differnent depending
  102. on how many directories are listed.
  103. ┌────────┐
  104. │ Create │
  105. └────────┘
  106. By choosing this option a file is created using a list formed by
  107. the choices selected.  If no directories where flagged then it
  108. doesn't create anything and exits to the BBS.  If there are flagged
  109. files a .ZIP file is created for user download.  The next version
  110. will auto-flag the file for download in the main BBS as soon as I
  111. figure out how to accomplish this task.
  112. The file created by the door is in the form of YRLSTx.ZIP where "x"
  113. is the node number of the BBS.  YRLST0.ZIP will be the file if the
  114. BBS is not running a multi-node system.
  115. ┌──────┐
  116. │ QUIT │
  117. └──────┘
  118. The user can return to PCBoard after they have finished using the 
  119. MACFILE Door. No file will be created even if some are selected.
  120.  
  121. ┌─────────┐
  122. │ GOODBYE │
  123. └─────────┘
  124.   Finally, the user can exit the BBS from the DOOR.
  125.  
  126. MACFILE Version 2.0                                             Page - 4
  127.  
  128. ╔══════════════╗
  129. ║ INSTALLATION ║
  130. ╚══════════════╝
  131.  
  132. Requirements:
  133.  
  134. - Dos 2.1 or higher
  135. - 80286 intel based machine or higher 
  136.     (Special requests for pre-80286 machines can be found at the authors BBS)
  137. - PKZIP MUST be in DOS path or local directory where MACFILE is installed
  138. - Enough memory for PKZIP to work (see PKZIP manual),macfile doesn't use much.
  139. - PCBoard 14.x (any version)
  140.  
  141. 1. Configure PCBoard for MACFILE door:
  142.      Using PCBoard's PCBsetup program, add the door to your list of doors.
  143.      Fields:
  144.         Filename        -        SYSOPs Choice   (must match startup file)
  145.         Password        -        SYSOPs Choice
  146.         Sec             -        SYSOPs Choice
  147.         Login           -        SYSOPs Choice (Not recommended)
  148.         User Sys        -        Yes
  149.         Door Sys        -        No
  150.         Shell           -        No
  151.         Path to Files   -        Not Needed
  152.  
  153. 2.  Make directory for MACFILE door
  154.      - Make a directory to hold the MACFILE door files.
  155.      - i.e.  mkdir \doors\MACFILE
  156.  
  157. 3.  Create the start up file i.e. MACFILE
  158.      - a sample is listed below
  159. --------------  cut here ----------------
  160.       @echo off
  161.       c:
  162.       cd \doors\macfile
  163.       macfile macfile.cnf
  164.       cd \pcb
  165.       board
  166. --------------  cut here ----------------
  167.  
  168. 4.  Copy files to appropriate places
  169.      - copy macfile door files to the MACFILE door directory.
  170.      - copy the startup file into the default PCBoard directory i.e. \pcb
  171.  
  172. 5.  Create the configuration file  i.e. MACFILE.CNF
  173.   #######################################################################
  174.   Sample macfile.cnf file
  175.   Line 1:  Location of file containing descriptions
  176.   Line 2:  Root name of Directory listings 
  177.            (i.e. It would be "DIR" for DIR1, DIR2, DIR3, etc)
  178.   Line 3:  Location to put the created ZIP FILE. (normally a "free" dir)
  179.            Filename is YRLSTx.ZIP where "x" is node number. (so there
  180.            is no conflict on a network)
  181.   Line 4:  Location where the ACTUAL DIRxx text files are located files
  182.            are located.
  183.   --------------  cut here ----------------
  184.   d:\doors\macfile\macfile.txt
  185.   dir
  186.   d:\pcb\free
  187.   d:\pcb\gen
  188.   --------------  cut here ----------------
  189.  
  190. MACFILE Version 2.0                                             Page - 5
  191.  
  192. 6.  Create the description file.
  193.   ##########################################################################
  194.   Sample macfile.txt File
  195.   Line 1:  Number of descriptions following Line 1: (min 1, max 120)
  196.   Line 2 - number in Line 1: descriptions of each directory. 
  197.            (max 20 chars in length) (it really doesn't matter if you put 50
  198.            only 20 wil be printed in the file listing) All chars allowed
  199.            spaces, slashes, numbers etc........
  200.            This description will also handle PCBoards @variables@
  201.   --------------  cut here ----------------
  202.   52
  203.   Archivers
  204.   Communications
  205.   BBS
  206.   PCboard
  207.   Virus/Security
  208.   Professional
  209.   Paradox
  210.   R:base
  211.   Database(s)
  212.   Benchmarks
  213.   Clipper
  214.   Education
  215.   Finance/Business
  216.   Health/Medical
  217.   FREEDownloads
  218.   TextFiles
  219.   Spreadsheet
  220.   Disk Utils
  221.   File/DirUitls
  222.   Shells/Menus
  223.   Periodical/src
  224.   MailReaders
  225.   Words/Editors
  226.   Batch Utils
  227.   Keyboard Utils
  228.   Memory Utils
  229.   Screen Utils
  230.   Misc Utils
  231.   Reserved
  232.   DOSSystem
  233.   MSWindows
  234.   OS/2
  235.   Multitasking
  236.   Lan/Networks
  237.   Science/Engineer
  238.   DTP/Clippart
  239.   Legal
  240.   CAD
  241.   Geoworks
  242.   GraphicsApp/Viewer
  243.   Games
  244.   Fonts
  245.   Reserved
  246.   Language: C/DOS
  247.   Language: C/UNIX/GNU
  248.   Language: C++
  249.   Language: ASM
  250.   Language: Pascal
  251.   Language: Basic
  252.   Language: Other
  253.   Programmers Tools
  254.   @X8F RECENT UPLOADS
  255.   --------------  cut here ----------------
  256.  
  257. MACFILE Version 2.0                                             Page - 6
  258.  
  259.  ╔═════════════════════════════╗
  260.  ║  A MÄC's Place BBS Release  ║
  261.  ╚═════════════════════════════╝
  262.  
  263. History of the File MACFILE Door Changes  [in reverse order]
  264. ═════════════════════════════════════════
  265.  
  266.     MACFILE 2.0:  22 Jan 1993
  267.  
  268.          o Went to version 2 because I wanted to keep the naming convention
  269.            the same and DOS only allows 8 chars.
  270.          o Added "Select All" menu item
  271.          o Added "DeSelect All" menu Item
  272.          o Added the "auto flag" feature.
  273.          o Supports 120 file dirs. 
  274.          o Added BBS name to the opening screen.
  275.          o Tidied up some of the string handers
  276.          o Fixed a couple of Small bugs
  277.          o Added better error reporting, (writes to callers log)
  278.          o Now you can "flag" file listing even if they are not on the
  279.            screen your looking at.  As each line is viewed as an 
  280.            Object
  281.  
  282.     MACFILE 1.0:  15 Jan 1993
  283.  
  284.          o Initial Public Release
  285.  
  286.     MACFILE 0.8ß: 5 Jan 1993
  287.  
  288.          o  Initial BETA release to a small group of BBS's.
  289.             I want to thank these folks  for their help.
  290.             Normally MÄC's Place has a group of 19 BETA sites
  291.             we use regularly, but this one went real clean.
  292.  
  293.             Channel One BBS            919-354-3137
  294.               SySops - Brian Miller/ Tess Heder
  295.  
  296.             FreeWare Hall Of Fame BBS  804-293-4710
  297.               SySop - Rey Barry
  298.  
  299.             Poor Boy's BBS             615-239-3073
  300.               SySop - Ron Herring
  301.  ╔═══════════════╗
  302.  ║  Future Plans ║
  303.  ╚═══════════════╝
  304.  
  305.  - Limit lists to take only "new since last" files if user desires
  306.  - Try and think of something else that might help out PCB users
  307.    Starting to run out of ideas.  Anyone ? (no NOT a mail door!)
  308.  - Win the MegaBucks lottery in Mass. and retire.
  309.  
  310.  
  311. MACFILE Version 2.0                                             Page - 7
  312.  
  313.  These  files  are  distributed  under  the  FreeWare concept - freely 
  314.  available  to PCBoard  SysOps. Please  Do Not   distribute  modified  
  315.  versions without permission of the author.
  316.  
  317.  Do Not remove this notice or any other copyright notice.
  318.  
  319.                          ╔══════════════════╗
  320.                          ║══════════════════║
  321.                          ║    DISCLAIMER    ║
  322.                          ║══════════════════║
  323.                          ╚══════════════════╝
  324.  
  325.  
  326.    THIS PRODUCT IS LICENSED  "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY
  327.    OR FITNESS  FOR  A  PARTICULAR  PURPOSE,  PERFORMANCE,  OR OTHERWISE. ALL
  328.    WARRANTIES ARE EXPRESSLY DISCLAIMED.  BY  USING  THE  FILE  MACFILE  DOOR 
  329.    PROGRAM    YOU AGREE THAT JOHN MCNAMARA WILL NOT BE  LIABLE TO YOU OR ANY 
  330.    THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE)  OR  PERFORMANCE OF THIS 
  331.    PROGRAMME, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT,  TORT 
  332.    OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE.
  333.  
  334.    You may not reverse-engineer, disassemble, modify,  decompile or  create
  335.    derivative works of this programme.  Piracy has been investigated by the
  336.    FBI and prosecuted under federal statutes.   Applicable law provides for
  337.    damages  and recovery of attorney's fees.   Distribution  of  any  MAC's 
  338.    Place BBS  Release program's  in  any  medium  without  its accompanying 
  339.    documentation is  an  unauthorized  modification.  That  is  a  theft of 
  340.    intellectual property.  
  341.  
  342.    ----------------
  343.      PCBoard  (C) is a registered trademark of Clark Development Company.
  344.      PKZip (C) is a register trademark of Phil Katz and PKWare, Inc.
  345.  
  346.     MACFILE Version 2.0                                             Page - 8
  347.                                  LICENSE
  348.                                  =======
  349.  The  MACFILE  PCBoard  Door  programme  can be  freely distributed  so
  350.  long  as  it  is  not  modified  or  sold  for  profit.  If you find that the
  351.  programme is  valuable, you  can send  a donation  for what  you think  it is
  352.  worth.  A donation of $5 is suggested.
  353.  
  354.  Please Send your contributions to:
  355.  
  356.  
  357.     MAC's Place BBS
  358.     ATTN:John McNamara
  359.     P.O. Box 911
  360.     Dunn, NC 28335
  361.  
  362.  If you have any questions, bugs, or suggestions, please contact:
  363.  
  364.                                    
  365.      John McNamara - SysOp         
  366.      Mäc's Place BBS               
  367.      (919) 891-1111 16.8K Dual Std
  368.  
  369.    The latest version is always available for downloading.
  370.  
  371. ╔══════════════════════════╗
  372. ║ File MACFILE Background: ║
  373. ╚══════════════════════════╝
  374.   John McNamara wrote all the code for File MACFILE in approximately 5 Hours.
  375.  
  376.   The File MACFILE door programme is written in C++  and was compiled with
  377.   Borland C++ 3.1  The MACFILE C LIBrary    The MACFILE source  code LIBrary
  378.   was modified  and recompiled  with our  specific improvements.  The C++
  379.   language  was choosen for  writing several of  the  MÄC's Place BBS PCBoard
  380.   utilities   such as   File MACFILE Door  because  of  its  speed and
  381.   flexibility.  The C++  source is available upon request and for small fee.  
  382.  
  383.      Author:
  384.                                      
  385.      John McNamara - SysOp           
  386.      MÄC's Place BBS                 
  387.      (919) 891-1111 [16.8 DS]
  388.  
  389.     MACFILE Version 2.0                                             Page - 9
  390. ╔═══════════════════════════════════╗
  391. ║ Other FreeWare By MAC's Place BBS ║
  392. ╚═══════════════════════════════════╝
  393. ZAP1.ZIP         1185  01-01-92  Interactive process killer for UNIX
  394.                                | SYSTEMS  "C" source
  395. XCHANGE.ZIP     35061  01-01-92  Find out where your calling in Mass
  396. YATSCOR1.ZIP    11000  01-01-92  Bulletin generator for EX-10 Yahtzee Door
  397. SOLSCOR1.ZIP    11000  01-01-92  Bulletin generator for EX-10 Solitairre Door
  398. AREA21.ZIP      21761  01-01-92  Areacode Identifier for the U.S.
  399. UPCASE.ZIP      15963  01-01-92  Convert Turbo Pascal key words to Upper Case
  400. MACGREP1.ZIP    11348  01-01-92  UNIX-Like Grep for DOS
  401. MACKILL2.ZIP    19856  05-30-90  Search & Destroy ! A "whereis" type Program
  402.                                | that prompts you to delete the file.  Scans
  403.                                | entire default drive, wildcards etc.  Brought
  404.                                | to you by MÄC's Place BBS. FREE From Door 2
  405. MACOPY1.ZIP     14966  03-31-92  MACOPY V2.0 Search all drives and 
  406.                                | directories for a file(s) and copy
  407.                                | it over to a different location.
  408.                                | Great for BBS's or large networks,
  409.                                | save all those "whereis" commands
  410.                                | prior to copy a file somehwere
  411. MACWHERE.ZIP    15050  03-31-92  MacWhere V2.0 extreamly fast Whereis
  412.                                | program, Search all drives and dirs.
  413.                                | Wildcards, pause mode, very fast.
  414.                                | Don't just search current drive, search
  415.                                | them ALL in the same amount of time
  416. MACWHICH.ZIP     8282  01-15-92  UNIX like "WHICH" for DOS. V2.0
  417.                                | Now find out what your about to run
  418.                                | BEFORE you run it.  Helpful on networks
  419.                                | to avoid running others creations.
  420.                                | Brought to you buy MÄC's Place
  421.                                | BBS and free from door 2
  422. MACWIN1.ZIP      3712  12-27-91  MAC WIN 2.0 for MS Windows 3.0 Increase
  423.                                | windows performance 5-10 times, by making
  424.                                | your windows screen writes fly.  Transparent
  425.                                | uses no memory, not a TSR.  It makes you
  426.                                | think you have a new computer.  Must have.
  427.                                | Works with all the favorites, Corel Draw, all
  428.                                | the games, WinWord, etc. FREE from MAIN BOARD
  429.                                | A MÄC's Place BBS release.
  430. KILLBAK4.ZIP     8196  01-15-92  Announcing!! Kill Bak V4.0 file Killer
  431.                                | Searches All drives/directories for files
  432.                                | ending in .BAK by default.  Now it takes
  433.                                | Arguments so it will hunt down ANY file
  434.                                | you want, wildcards accepted. VERY fast
  435.                                | Works across Novell, 3-Comm, Lantasic &
  436.                                | many other networks including PC-NFS so
  437.                                | now you can even search UNIX drives.
  438.                                | Brought to you buy MÄC's Place
  439.                                | BBS and free from door 2
  440. HOTDOG31.ZIP    60024  01-01-92  PCB 11,12,14 User Base Management utility
  441. HOWLONG.ZIP     21760  05-31-90  Time the execution of any program.. Great
  442.                                | for bench marking your programs. Yet another
  443.                                | MÄC's Place utility. Free from door 2
  444. HSTUFF41.ZIP    63303  08-30-90  HOTSTUFF V4.1 Popular file & Statistics
  445.                                | report for PCBoard.  A must for PCBoard
  446.                                | SYSOPS. Brought to you by MÄC's Place
  447.                                | Removed Co-Processor specific switch,
  448.                                | Sorry about that folks
  449. HCOMP40.ZIP     12266  08-30-90  HOTSTUFF Companion V4.0 Strips unwanted lines
  450.                                | from Files.  A MUST for HOTSTUFF or ProWho
  451.                                | Now strips up to 3 patterns at a time
  452.                                | Brought to you by MÄC's Place
  453. EDITPTH3.ZIP    11734  05-30-90  Edit your DOS PATH without rebooting your
  454.                                | computer.  Version 3.0 Brought to you by
  455.                                | MÄC's Place. Its freeware
  456. DATEKILL.ZIP     8000  01-01-92  Deletes PCBOARD caller log/any file when it
  457.                                | gets to be a certain day of the month
  458. CHKTXT.ZIP      33550  01-01-92  Determines Readability of Text files
  459. BOPDIR2.ZIP     18970  01-15-92  he ultimate recursive directory deleter,
  460.                                | Fast, delete's a directory, any sub-dirs
  461.                                | and files found in the dirs.  Brought to
  462.                                | from MAIN BOARD.  Used to be KILLDIR
  463. BUDMAN30.ZIP    12151  08-30-90  BUDMAN V3.0 DOWNLOAD.TXT file splitter for
  464.                                | PCBoard twice as fast as prev vers. **vg**
  465.                                | Brought to you by MÄC's Place
  466. CALLKILL.ZIP    11000  01-01-92  Deletes caller log or any file when it
  467.                                | gets to big
  468. MACORG31.ZIP    75606  01-24-93  ORIGIN DOOR V3.1 for PCBoard 14.x 
  469.                                | File history tracing.  A who UL/DL that
  470.                                | file Door, faster than all existing doors
  471.                                | of similar type. Now scans 1 or 2 files !
  472.                                | Full screen help, 4% faster, files report.
  473.                                | New presentation layout, easy to install. 
  474.                                | Nothing is faster.  FreeWare from MÄC's 
  475.                                | Place BBS
  476. MACRM11.ZIP     22357  01-21-93  MACRM V1.1 for PCBoard 14.x - 15.x
  477.                                | Removes files & descriptions from PCBoard
  478.                                | directory listings. Handles unlimited 
  479.                                | number of files and dirs. Runs from 
  480.                                | constructed lists of files and dir 
  481.                                | locations.  Very fast and safe. Saves tons
  482.                                | of time when processing large amount of
  483.                                | data.  FREEWARE from MÄC's Place
  484. EZCOMP20.ZIP    99098  01-24-93  EZComp Version 2.0
  485.                                | Unix compatible compress/uncompress
  486.                                | for DOS. Extreamly Fast, true 32bit,
  487.                                | runs in 386 protected mode, (386+
  488.                                | required), full 12 - 16 bit support. 
  489.                                | Uses extended/expanded/Xms/Disk for
  490.                                | extra mem if needed. Supports older
  491.                                | unix compress, stdin etc..Rel:7/12/92
  492.                                | FreeWare from MÄC's Place BBS.
  493. MACSEC11.ZIP    79465  01-24-93  MAC SEC V1.1 for PCBoard 14.x is an ON-LINE
  494.                                | Security Upgrade Door for your users. Lets
  495.                                | your users upgrade themselves, without
  496.                                | waiting for an event to occur.  Protect up 
  497.                                | to 50 levels, File or Byte ratio, allow
  498.                                | 50 levels to be altered.  Very fast and
  499.                                | safe.  A MAC's Place BBS release. 
  500.                                | BUG FIX, now reads correct .cfg FreeWare..
  501. MACUP1.ZIP       6800  01-24-93  MACUP V2.0 PCBoard Local File Uploader
  502.                                | Allows local uploads, handles wildcards,
  503.                                | appends any dir file as well as moves
  504.                                | actual file to proper directory. Handles
  505.                                | multiple description lines also.  -VG-
  506.                                | Another Freeware program from MAC's Place
  507.                                | BBS
  508. KEEPCALL.ZIP    11000  01-01-92  Keeps PCBoards Caller logs a a user defined 
  509.                                | Size.  Designed to run in an event, you tell
  510.                                | it what size you want and it will trim your
  511.                                | callers log to the appropriate size.  
  512.                                | Maintains 64 column integrity
  513.